.\"   $Id: GENLIB_FLATTEN_LOFIG.3,v 1.1 2002/03/08 14:08:10 fred Exp $
.\" @(#)GENLIB_FLATTEN_LOFIG.3 2.11 91/08/22; Labo Cao-vlsi; Author : Frederic Petrot
.if t \{\
.so man1/alc_contents.mac
.XS \n%
.ti 0.2i
GENLIB_FLATTEN_LOFIG
.XE \}
.TH GENLIB_FLATTEN_LOFIG.3 "October 1, 1997" "ASIM/LIP6" "PROCEDURAL GENERATION LANGUAGE"
.SH NAME
GENLIB_FLATTEN_LOFIG \- flatten an instance in the current netlist figure
.SH SYNOPSIS
.nf
.if n \{\
.ft B \}
.if t \{\
.ft CR \}
#include <genlib.h>
void GENLIB_FLATTEN_LOFIG(insname,concat)
char \(**insname;
char concat;
.ft R
.fi
.so man1/alc_origin.1
.SH PARAMETERS
.TP 20
\fIinsname\fP
Name of the instance to be flattened
.TP
\fIconcat\fP
Indicate whether or not to concatenate instance name to instance' objects name
.SH DESCRIPTION
\fBFLATTEN_LOFIG\fP inserts the contents of an instance, but its connectors,
in the current figure, and then destroys the instance.
.br
The \fIconcat\fP parameter may take two values:
.TP
\fBYES\fP
to concatenate object name with instance names.
.TP
\fBNO\fP 
to copy object names.
.LP
In most case, the \fIconcat\fP value must be \fBYES\fP, in order to warranty
the unicity of names in the figure.
It may otherwise fail, because the function would try to add in the current
figure some object with an already existing name.
.SH EXAMPLE
.nf
.if n \{\
.ft B \}
.if t \{\
.ft CR \}
#include <genlib.h>
main()
{
	/\(** Create a figure to work on  \(**/
	GENLIB_DEF_LOFIG("mycell");
	.
	.
	.
	/\(** Place an instance \(**/
	GENLIB_LOINS("model","instance", "sig1", "sig2", EOL);
	/\(** flatten an instance \(**/
	GENLIB_FLATTEN_LOFIG("instance", YES);
	/\(** Save all that on disk \(**/
	GENLIB_SAVE_LOFIG();
}
.ft R
.fi
.SH SEE ALSO
.BR genlib (1),
.BR GENLIB_UNFLATTEN_LOFIG (3).
.BR GENLIB_LOINS (3).


.so man1/alc_bug_report.1

